主题
设置模块总览 - Overview
本分类做什么
全局级 插件配置：版本、路径、机器码、字符串编码、大块 GetConfig/SetConfig 与 SetConfigByKey 键值。多数 绑定模式、截图后端、键鼠、数据库路径 等均通过此处或 SetConfigByKey 配置，是本仓库中 影响面最大 的分类之一。
一、信息与只读
| 接口 | 差异 |
|---|---|
| Ver | 插件 版本号 字符串。 |
| GetBasePath | 插件 安装/加载根路径。 |
| GetMachineCode | 机器码（常与 授权 绑定）。 |
二、路径
| 接口 | 差异 |
|---|---|
| GetPath、SetPath | 全局工作路径；与 文件 读写配合。 |
三、VNC 窗口坐标（客户区偏移）
| 接口 | 差异 |
|---|---|
| SetClientLocation | VNC 全屏截图等无法读取窗口屏幕位置时，设置客户区在远程帧中的左上角偏移；不改截图，找图/找色返回坐标减偏移，鼠标传入坐标加偏移。 |
适用：已 BindWindowEx display=vnc，脚本仍按窗口相对坐标写逻辑。
四、编码
| 接口 | 影响范围 |
|---|---|
| SetDefaultEncode | 字符串参数/返回 的默认编码（GBK/UTF-8/Unicode 等，见详情页）。 |
与 Config相关：后者管 库内 KV；本处管 整插件字符串约定。
五、GetConfig / SetConfig（大块配置）
| 接口 | 差异 |
|---|---|
| GetConfig | 读取 整段 配置（常为 JSON/INI 结构，见详情页）。 |
| SetConfig | 写回 整段。 |
适用：一次改 多个相关键（如绑定+截图+键鼠一组）。
六、SetConfigByKey（单键）
| 接口 | 差异 |
|---|---|
| SetConfigByKey | 单个 key 修改；部分键 无需创建 OLA 对象 即可调用（见详情页与更新日志）。 |
| JSON配置解析约定 | SetConfig / OCR / YOLO 模型调参 共用 JSON 解析规则。 |
与 SetConfig 差异：热改一项、脚本更短；不必 读-改-写整文件。
七、与其它模块
| 模块 | 典型键 |
|---|---|
| 窗口/绑定 | 绑定模式、截图模式 |
| 图像识别 | 匹配阈值、弹窗开关 |
| 数据库 | DbPath、默认库 |
八、快速选型
| 需求 | 建议 |
|---|---|
| 改一项后台键鼠参数 | SetConfigByKey |
| 迁移整机配置 | GetConfig → 编辑 → SetConfig |
| 乱码 | SetDefaultEncode + 文档中的 ReturnEncoding 相关键 |
九、注意
- 键名 随版本扩展；以 官方配置文档/更新说明 为准。
- SetConfig 覆盖错误可导致 无法绑定，先 备份。